home *** CD-ROM | disk | FTP | other *** search
/ The AGA Experience 3 / AGA Experience Volume 3 (1997)(NFA - SAdENESS)[!].iso / software / utilities / graphics / picturedt-v43 / readme next >
Text File  |  1996-12-14  |  10KB  |  314 lines
  1.  
  2.                         picture.datatype V43
  3.                           Copyright 1995-96
  4.                            Ralph Schmidt
  5.            Additional libs/tools/changes by F.Mariak/M.Scheler
  6.            All sub datatypes by Matthias Scheler
  7.  
  8.  
  9. This  version is a freely available picture.datatype that MUST ONLY be used
  10. with  a  licenced  CyberGraphX(TM)  software  package  when using non 8 bit
  11. screenmodes.  You aren't allowed to use this software with any non licenced
  12. CyberGraphX(TM)  "emulation"  in these modes.
  13.  
  14. THE DATE EXPIRATION CODE HAS BEEN REMOVED. IT DOES NOT EXPIRE AFTER 4MONTH
  15. ANYMORE.
  16.  
  17. cyberncg.library support for non CyberGraphX machines has been dropped.
  18.  
  19. ******************************************************************************
  20.  
  21. Reporting bugs:
  22.  
  23. If   you   find   any   bugs   in   this  software,  please  send  them  to
  24. cybergfx.dtbugs@vgr.com.   Since  this  software is unsupported, we make no
  25. guarantees  about  how  long  it will take to fix the bug, or if it will be
  26. fixed  at  all.   Bug fixes will be cheerfully accepted.  Please include as
  27. much detailed information as possible, including:
  28.  
  29.     1) the version numbers of the related libraries/datatypes you are
  30.        using
  31.     2) the data file that caused the bug (if its not too big)
  32.     3) the OS version and machine type you ran the program on
  33.  
  34. ******************************************************************************
  35.  
  36. #########################
  37. #                       #
  38. #Important Informations #
  39. #                       #
  40. #########################
  41.  
  42. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  43. IF YOU'RE USING THE APPS THAT ARE IN THE COMPATIBILITY LIST( CHECK OUT SOME
  44. LINES  BELOW)  YOU  HAVE  TO NAME YOUR APPLICATION EXACTLY LIKE IN THE LIST
  45. OTHERWISE WON'T RECOGNIZE IT.
  46. !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
  47.  
  48. The  Aminet  release  of the png.datatype supports the V43 picture.datatype
  49. but  because  of  a  late change to the API(DTA_ErrorLevel,DTA_ErrorNumber)
  50. these  don't  support  these  tags.   I  hope  that  the authors of these 2
  51. datatype update their datatypes in the next time.
  52.  The  tags  are VERY important in a low memory situation.
  53.  
  54.  A  V43  compatible tiff.datatype as well as an bmp.datatype have also been
  55. released so far.
  56.  
  57.  
  58. Problems
  59.  
  60. o PPaint doesn't load 24bit images. Well..PPaint checks the BMHD.depth of
  61.   the raw data for >8...too bad
  62.  
  63. o Picview outputs "not a standard bitmap or something like that". This
  64.   is caused by the cgfx "PLANESTOFAST" option.
  65.  
  66. The following functions aren't implemented yet.
  67.  
  68. o 24bit dithering to a very small depth planar bitmap may cause
  69.   "problems". No time to test this out.
  70. o Sorry...also no time(lazyness) to test out PixMap support. I hope
  71.   it works as defined.
  72. o Right now it also doesn't really care for Ham6/8 and Halfbright.
  73. o DTM_Print for truecolour pictures should differ the picture to 256 colours
  74.   and then print it.
  75. o Make a Gauge interface so it may be controlled by tags(but does that
  76.   really make sense ? imagine a gauge popping up when iprefs is loading
  77.   your background)
  78. o scrollable transparent picture handling should be improved.
  79.   Now it only switches back in nonmask mode.
  80. o ******* AMosaic crashes ******* in 16Bit mode...i don't know why
  81.   yet(it worked in that mode in summer of 95 ......).
  82.  
  83.  
  84. ############################################################################
  85.  
  86.  
  87. The jfif.datatype is using the "jpeg.codec"
  88.  
  89. The JPEG codec is Copyright © 1994 Christoph Feck, TowerSystems.
  90. All Rights Reserved.  It is based in part on the work of the
  91. Independent JPEG Group.
  92.  
  93. ############################################################################
  94.  
  95.  
  96.  
  97.  
  98. ****************************************************************************
  99.  
  100. ATTENTION:
  101.  
  102. YOU  NEED TO HAVE AT LEAST VERSION 40.66 OF CYBERGRAPHICS.LIBRARY INSTALLED
  103. TO  USE THIS RELEASE OF PICTURE.DATATYPE V43 IN CONJUNCTION WITH A GRAPHICS
  104. CARD !
  105.  
  106. IF YOU INSTALL THIS ARCHIVE ON A DRACO BASED SYSTEM PLEASE MAKE SURE NOT TO
  107. INSTALL THE CYBERGRAPHICS.LIBRARY COMING WITH THIS ARCHIVE !
  108.  
  109. ****************************************************************************
  110.  
  111. Release Notes
  112.  
  113. V43.757
  114.  
  115.  o fixes some trouble with crashes on certain machines
  116.  
  117. V43.755
  118.  
  119.  o new pcdt prefs program v43.3 included. It also works now when the v43
  120.    picture.datatype is actually not running
  121.  o new sub classes included
  122.  o added stack swapping code to picture.datatype dispatcher in order to fix
  123.    stack overflow related problems with applications which do not allocate
  124.    enough stack space
  125.  
  126. V43.754
  127.  
  128.  o fixed some bugs in method DTM_DRAW
  129.  o fixed some problems in conjunction with halfbrite source data
  130.  o new gif.datatype 43.14 included
  131.  
  132. V43.753
  133.  
  134.  o new pcdt prefs program v43.2 included
  135.  o the preferences file now has moved to env:sys
  136.  o new gif.datatype 43.13 included which fixes some strange crash problems
  137.  o fixed some problems in conjunction with planar graphic formats which
  138.    occasionally led to strange looking mwb-patterns
  139.  
  140. V43.751
  141.  
  142.  o the public semaphore is now available even if the picture.datatype is
  143.    expunged. This fixes a severe crash when the library is expunged
  144.  
  145. V43.750
  146.  o fixed a BYTE-READ from $0 when non v43 compatible applications called the 
  147.    picture.datatype
  148.  
  149. V43.748
  150.  
  151.  o gtlayout.library included in this archive. (required for the prefs
  152.    program)
  153.  o The application list which contains all V43 compatible applications may
  154.    now be configured with a seperate prefs program.
  155.  o removed support for environment variable "cybergraphics/pcdt_dither"
  156.    Please use the supplied prefs program PCDT to change dither settings now
  157.  o the expiration time is now 4 month instead of 1 month. So users who
  158.    can not access the net but get the datatype from an aminet cd are able
  159.    to use the picture.datatype release  for a certain amount of time
  160.    until a new version is released on cd
  161.  o there is an installer script now for v43 datatype installation which
  162.    also includes a backup option
  163.  o Tower JPEG Codec Class included as seperate archive
  164.  o new gif.datatype sub class V43.12 included
  165.  
  166. V43.718
  167.  
  168.  o bug fix in conjunction with datatype objects which require
  169.    mask planes and use planar bitmaps
  170.  o API-Demo source for datatype to ppm conversion added
  171.  o new versions of sub datatypes included
  172.  
  173. V43.716
  174.  
  175.  o ENV: "cybergraphics/pcdt_dither"
  176.    0 == Floyd Dithering(Better,slower) (DEFAULT)
  177.    1 == Ordered Dithering(Faster,Not so good gfx quality)
  178.  
  179. V43.713
  180.  
  181.  o new cybergraphics.library prerelease included
  182.  o the picture.datatype now uses ordered dithering as default.
  183.    A switch to select between floyd or ordered may follow in the
  184.    future
  185.  o included a new cyberncg.library which fixes a problem with
  186.    transparent images
  187.  o added V43 compatible PCX sub datatype to archive
  188.  
  189. V43.695
  190.  
  191.  o now supports AGA/ECS machines with cyberncg.library included in this archive.
  192.  
  193. V43.684
  194.  
  195.  o some internal structures have changed. Please use the new
  196.    cybergraphics.library coming with this archive
  197.  o the picture.datatype expires after a few weeks now
  198.    (all pre release versions will do that in the future)
  199.  o fixed a problem in conjunction with PDTA_DestBitMap and
  200.    ODF_USEFRIENDBITMAP which caused twice freed BitMaps in
  201.    the past
  202.  
  203. V43.667
  204.  o Fixed a 24bit->8Bit(OldBitmap) Dither problem.
  205.    Was caused by a change of the CyberBitmap checking code.
  206.    This may be the problem some experienced with PPaint which
  207.    i don't have to test it out...
  208.  
  209. V43.658
  210.  o Fixed a MUI Pattern problem
  211.  o Added DTM_DRAW...not tested
  212.  
  213. V43.647
  214.  o Fixed the remap problem some people experienced
  215.  
  216. V43.629
  217.  o Finally fixed the mysterious crash bug.
  218.  
  219. V43.6xx
  220.  o Multiview cludge
  221.  o Smarter Monitor ID overruling
  222.  o Alphachannel support
  223.  o fixed PDTA_DestMode,MODE_V42 fallback..
  224.  o Added an internal V43 compatibility list with the current entries:
  225.     "« IPrefs »",
  226.     "multiview",
  227.     "amigaguide",
  228.     "amosaic",
  229.     "amosaic-as225",
  230.     "amosaic-amitcp",
  231.     "DirectoryOpus",
  232.         NULL
  233.  o Fixed Aspect=0 save problem
  234.  o smarter PDTA_UseFriendBitMap that only does something when needed
  235.  o Truecolour alphachannel mask generation activated...will be used
  236.    automaticly by OM_RENDER
  237.  o 8Bit transparent mask generation activated...will be used automaticly
  238.    by OM_RENDER
  239.  o Fixed V42 fallback mode mungwall problems with dithering..hopefully.
  240.  o OM_Render transparent special handling..see docs for more infos
  241.  o Subdatatype Error API improvement
  242.  o creating transparent mask without layout if needed
  243.  o Fixed long outstanding V42 fallback color problem bug visible with DirOpus and others.
  244.  
  245. V43.451
  246.  o Important!!!!!
  247.    Include Change
  248.    DTM_BLITPIXELARRAY -> DTM_WRITEPIXELARRAY
  249.  
  250.  o PDTA_DEST works now. This means if PDTA_DEST,MODE_V43 isn't set
  251.    by application programs, a slow old planar bitmap is returned to
  252.    not break old programs that can only handle that bitmap.
  253.    Sigh..i could add an application list that works bitmaps format
  254.    independent.
  255.    Only exception is IPrefs for now...it gets a chunky bitmap.
  256.  
  257.  o PDTA_UseFriendBitMap is implemented(Stuntzi)
  258.  
  259.  o PDTA_NumPixMapDir
  260.    DTM_CREATEPIXMAPDIR
  261.    DTM_FIRSTPIXMAPDIR
  262.    DTM_NEXTPIXMAPDIR
  263.    DTM_PREVPIXMAPDIR
  264.    DTM_BESTPIXMAPDIR
  265.  
  266.    added to support multi-volume gfx formats like TIFF.
  267.  
  268.  o DTM_READPIXELARRAY added to avoid the sub datatype data sharing
  269.    design problem of the picture.datatype. If you ask me i would
  270.    have disallowed any data sharing at all because it destroys the
  271.    meaning of OO.
  272.  
  273.  o GAUGE disabled...there should be GAUGE Method imho
  274.  
  275. V43.395
  276.  
  277.  o Added a cludge to avoid a BestModeID crash
  278.  o Added a Volume Gauge...will be configurable in the future
  279.  o ilbm.datatype that handles 24bit...thanx Matthias
  280.  
  281. V43.352
  282.  
  283.  o Fixed a problem with WBPattern(not only this) and some pictures.
  284.    The reason was that BestCModeIDTagList() doesn't always work
  285.    and i had no fallback mode so the returned monitorid was INVALID.
  286.    This caused a lot problems..expecially the HAM/HALFBRIGHT bit test
  287.    on the modeid resulted into a wrong decision because INVALID=-1.
  288.  
  289. V43.340
  290.  
  291.  o DTM_PRINT added. It does nothing for 24Bit bitmaps.
  292.  
  293. V43.338
  294.  
  295.  o DTM_COPY added. It writes 8Bit and 24Bit output.
  296.  
  297. V43.335
  298.  
  299.  o DTM_WRITE added. It writes 8Bit and 24Bit output.
  300.  
  301.  
  302.  
  303.  
  304.  
  305.  
  306.  
  307. Questions&Bugreports
  308. Don't expect fast response.
  309.  
  310. Ralfph Schmidt
  311. laire@popmail.owl.de
  312.  
  313.  
  314.